Repository navigation
Add recommend: one pick and the next step for a need (MCP, WebMCP, REST) - #399
Merged
Merged
Conversation
…and GET /api/recommend Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
…(9 tools), MCP 1.10.0, OpenAPI 1.14.0 Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
…oint-4867 Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
cursor Bot
pushed a commit
that referenced
this pull request
Nov 13, 2026
Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
assafbar2
added a commit
that referenced
this pull request
Nov 13, 2026
…earch robots group (#401) * AEO: answer-first task pages, /tasks/<slug>.md, an agent meta line and a robots group for AI search Co-authored-by: assaf.barnir <assaf.barnir@sentry.io> * robots: add the AI search group without touching the * group's rules Co-authored-by: assaf.barnir <assaf.barnir@sentry.io> * Merge origin/main into #401 (after #399); release 2.10.4 Co-authored-by: assaf.barnir <assaf.barnir@sentry.io> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
1 task done
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
An agent can now send its user's need in a sentence and get back one pick per need, why it fits, the next step to start using it, and two alternatives. It's offered as:
recommend(read-only annotations),recommend,GET /api/recommend?need=….The pick is the Operator's (
lib/operator.ts), so there's no model and no per-call cost, and the same need always gets the same answer.What a reply holds
recommendations[]:need,task,pick,pickedBecause,why,unmet,nextStep,alternatives(2),fits.nextStepreuses the connect-bundle logic. It is the MCP config to paste when the vendor's docs give an address or command, else the MCP setup guide, else the vendor's docs.answer: the same in plain sentences, one line per need.stackUrlwhen there are two or more picks, plusoperatorUrl,basisandnotes.no_need. A need no task matches is a 404no_matchthat names the closest tasks, rather than returning a weak pick.Organic results
organicOrder), and replies pass throughwithoutPlacement.tests/organic-surfaces.test.tsnow runs fourrecommendcalls on both the MCP and WebMCP surfaces against a catalog where half the listings are featured and sponsored. The answers must be identical to the unplaced ones and carry no placement field.Privacy and crawling
/api/recommendto crawlers, since every need is a new URL.Docs and manifests kept in step:
llms.txt,index.md,/for-agents,/connect, the homepage tool lines,skill.md,docs/API.md, README, DISTRIBUTION, the Cursor plugin README,openapi.json,/.well-known/mcp.jsonandwebmcp.json(server version 1.9.0), the MCP smoke script and the e2e machine-endpoint tests.Not changed:
CHANGELOG.mdand the package version, so the What's new page is untouched.Checks run: typecheck, lint, the full test suite (786 tests), content validation, the production build, the Try it link check, and
scripts/mcp-smoke.mjsagainst a local production server (all pass).